home *** CD-ROM | disk | FTP | other *** search
/ Mission 3 / Mission 3.zip / Mission 3.iso / grafik / my_play / mplyr_en.doc < prev    next >
Text File  |  1998-03-02  |  8KB  |  267 lines
  1. ****************************************************************************
  2.             M_PLAYER.PRG DOCUMENTATION
  3. ****************************************************************************
  4.  
  5.          It's a Quick Time and AVI player with sound,
  6.       and a FLI/FLC/FLH, SEQ, PI1+DLT, FLM, DL, GIF, CDH, CDL,CDV player.
  7.           It can also CREATE Quick Time files (Images & sound),
  8.                   or AVI files (Images & sound)
  9.                   of FLM files (Images & sound)
  10.               or GIF animated files (without sound)
  11.  
  12.  
  13. Author:
  14.  
  15. TELLO Guillaume
  16. 240 rue Estienvrin
  17. 49260 Montreuil Bellay
  18. FRANCE
  19.  
  20. Email: gtello@wanadoo.fr
  21.  
  22. Download M_PLAYER from:
  23.     http://perso.wanadoo.fr/gtello (my page)
  24.     http://www.tripnet.se/~mille
  25.     http://www.magmacom.com/~nima
  26.         ftp://193.190.205.13/Archive/atari
  27.     http://www.allatsea.demon.co.uk
  28.  
  29.         (Besides, you'll find the STE version too).
  30.  
  31. ********** Shareware ****************
  32.  
  33.     If you want to register, please send 15DM, CAN$15, US$10, 60F or
  34. 7UKP to me or to my bank:
  35.     Crédit Agricole Anjou Mayenne/49000 Angers (France)
  36.     Account n°10434852000
  37.  
  38.     North America User, you can register (US$10) at:
  39.  
  40.     Nima Montaser          Hardware and Software Specialists
  41.     Homa Systems House       ATARI Graphics and Multimedia
  42.        P.O. Box 52127          nima@magmacom.com
  43.        Ottawa, ON  K1N 5S0     aa414@freenet.carleton.ca
  44.        Canada   Tel:(613)722-0901   Fax:(613)722-9061
  45.                URL: http://www.magmacom.com/~nima
  46.  
  47.         UK users, you can register (7UKP or more!) at:
  48.  
  49.         Antony Lacey   (algy@allatsea.demon.co.uk)
  50.     59 Owenford Road
  51.     Radford
  52.     Coventry CV6 3FQ
  53.     England
  54.  
  55.  
  56.         G E N E R A L   C O N S I D E R A T I O N S
  57.         *******************************************
  58.  
  59. Capabilities:
  60. ¨¨¨¨¨¨¨¨¨¨¨¨¨
  61.     1) Can create Quick Time movies from a serie of images (and an
  62. optional sound), images formats are:
  63.         - TGA2 16 or 24 bits (to RLE16 compression)
  64.         - IMG ('ximg', 256 colors) (to RLE8 compression)
  65.     Sound formats are:
  66.         - AVR, 8/16 bits, mono/stereo
  67.         - WAV, 8/16 bits, mono/stereo
  68.     (see below BATCH files, and SLIDSHOW.DOC)
  69.  
  70.         2) Can create Video for Windows (AVI) movies from a serie of
  71. images (and an optional sound), images formats are:
  72.         - IMG ('ximg', 256 colors) (to RLE8 compression)
  73.     Sound formats are:
  74.         - AVR, 8/16 bits, mono/stereo
  75.         - WAV, 8/16 bits, mono/stereo
  76.     (see below BATCH files, and SLIDSHOW.DOC)
  77.  
  78.     3) Can create GIF Animated files from a serie of GIF images (87a
  79. or 89a):
  80.         - M_PLAYER extension with number of frames
  81.         - DELAY extension with the timing infos
  82.         - NETSCAPE extension with the looping infos
  83.     (see below BATCH files, and SLIDSHOW.DOC)
  84.  
  85.     4) Can create Extended FLM files from a serie of ST-Low pictures
  86. and an optionnal sound:
  87.         - Images DEGAS (320x200x16)
  88.         - Images NEO (320x200x16)
  89.         - AVR/WAV sounds (DMA freq +/-2%, 8bits, mono/stereo)
  90.  
  91.     5) Can play 11 types of animations:
  92.     - *.MOV (Quick Time)
  93.         - graphics with:
  94.             CVID (compressed yuv)
  95.             RLE1, RLE2 (grey or col), RLE4 (grey or col),
  96.             RLE8 (grey or col), RLE16, RLE24, RLE32
  97.             SMC8 (grey or col)
  98.             RAW1, RAW2 (grey or col), RAW4 (grey or col),
  99.             RAW8 (grey or col), RAW16, RAW24, RAW32
  100.             RPZA (15 bits)
  101.             WRLE (256 colors)
  102.             MSVC8 (grey or  col) MSVC16
  103.             YUV2, YUV9, YVU9 (uncompressed yuv)
  104.         - sound mono/stereo, 8/16 bits with TWOS or RAW format
  105.         - switch for image-sound synchronisation
  106.         - switch for sound
  107.     - *.AVI (Video for Windows)
  108.         - graphics with:
  109.             CVID
  110.             CRAM16, CRAM8
  111.             MSVC16, MSVC8
  112.             RLE8
  113.             RGB8
  114.             YUV9, YVU9, IV32
  115.         - sound mono/stereo, 8/16 bits with TWOS or RAW format
  116.         - switch for image-sound synchronisation
  117.         - switch for sound
  118.  
  119.     - *.FLI/FLC/FLH (Autodesk Animator)
  120.     - *.SEQ        (Cyber Paint)
  121.     - *.PI1 + *.DLT    (Cyber)
  122.     - *.FLM        (Kinetic Microsystems)
  123.     - *.FLM        (Lexicor)
  124.     - *.DL        (types 1 and 2)
  125.         - graphics only
  126.         - normal speed or maxi speed
  127.         - loop mode (Shift key)
  128.         (for PI1 + DLT, you must select the PI1 file, then the DLT
  129.         file must share the same name and be located into the same
  130.         directory: c:\EXAMPLE.PI1 and c:\EXAMPLE.DLT)
  131.  
  132.     - *.FLM     (Extended FLM Lexicor)
  133.         - images 320x200x16, 640x480x16 or 640x400x2
  134.         - sound DMA 8 bits mono/stereo at 12017, 25033 or 50066 KHz
  135.         - independent timing for each frame
  136.  
  137.     - *.FLM        (Video Master V1.0)
  138.         - images 160x100x16 (VMAS)
  139.         - images 160x100x256 (VFAL)
  140.         - sound 8 bits, mono, any frequency
  141.  
  142.     - *.GIF        (Compuserve, 87a and 89a)
  143.         - synchro or not with the delays (version 89a)
  144.         - number of frames displayed in the stats dialog only
  145.  
  146.     - *.CDH, *.CDL, *.CDV    (CD Stratos Magazine)
  147.         - images mono (CDH) fitting in 640x400
  148.         - images 16 greys (CDL) fitting in 320x200
  149.         - images 256 colors (CDV) fitting in 640x480
  150.           (an IFF file with the same name, except last char, must
  151.           be located into the same folder to get the palette!
  152.           ex: TEST9.CDV must come with TEST1.IFF).
  153.         - DMA sound 8 bits mono 12516Hz
  154.  
  155.     - step by step mode
  156.         - every frame displayed (auto or not)
  157.         - can save this frame into a TGA file (auto or not)
  158.         - doesn't work with NOVA or TT 256 colors
  159.  
  160.     - *.BAT (Batch files for slideshow):
  161.         - simple language to load and display a serie of images
  162.         - image format:
  163.             TGA 2 uncompressed (your POV creations for example)
  164.             IMG ('XIMG' and 256 colors)
  165.             GIF (87a or 89a, 256 colors maxi)
  166.             PI1 (DEGAS 320x200x16)
  167.             NEO (Neochrome 320x200x16)
  168.         more formats will be added in the furture
  169.         (see SLIDSHOW.DOC)
  170.  
  171.     - *.BAT (Batch Files)
  172.         - animations chained of any type
  173.         - can loop
  174.         (see SLIDSHOW.DOC)
  175.  
  176.  
  177. Hardware requiered:
  178. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  179.     - Atari TT030:
  180.         - with or without CaTTamaran 48MHz
  181.         - graphic cards accepted:
  182.             - NOVA (256, 32768 or 65536 colors)
  183.             - Crazy Dots1/2 (256 or 32768 colors)
  184.             - Matrix (256 colors)
  185.             - Cyrel (256 colors)
  186.         - without graphic card (256 colors)
  187.  
  188.     - Falcon, True Color (32768 colors) and plenty of RAM (Outside
  189.     accepted! Afterburner 040, ScreenBlaster, Blow up,
  190.     Centurbo I)
  191.     - PowerBook with MagicMac (256 colors, without sound...)
  192.     - HADES 040/060 (same as with TT+NOVA card) with sound:
  193.         - on the old Yamaha (default)
  194.         - P-SOUND card (parallel port)
  195.  
  196.         R U N N I N G   T H E   P R O G R A M
  197.         *************************************
  198.  
  199. The files:
  200. ¨¨¨¨¨¨¨¨¨¨
  201.     M_PLAYER.PRG    ; the program
  202.     M_PLAYER.RSC    ; the dialogs (put into the same folder!)
  203.     MPLYR_FR.DOC    ; french documentation
  204.     MPLYR_EN.DOC    ; english documentation (Thanks Dave!)
  205.     MPLYR_GE.DOC    ; german documentation (Thanks Martin)
  206.     MPLYR_SV.DOC    ; swedish documentation (Thanks Mille)
  207.     MP_ICONS.RSC    ; 4 icons made by Julien Chauveau for your desktop.
  208.     SLIDSHOW.DOC    ; batch files and MOV-Maker
  209.     HISTORIC.TXT    ; the history
  210.     COMMANDS.DOC    ; the options of the command line (TTP mode)
  211.  
  212. Running:
  213. ¨¨¨¨¨¨¨¨
  214.     The 'Go' button can come with the Alt key to get:
  215.     - the step by step mode (AVI, MOV or FLx)
  216.     - the creation of an animation with a BATCH file (else, you get
  217.     only the slideshow of images).
  218.  
  219.     You can specify a mask as the filename (*.MOV)
  220.  
  221.     For the use of a window, you can specify the default mode with a
  222. RSC editor ('W' button selected or not).
  223.  
  224. How to stop an animation?
  225. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  226.     With the 'Control' key (no stats box).
  227.     With SHIFT and an animation that loops (GIF for example), the
  228. display is stopped at the end of the current loop and you get the stats
  229. box.
  230.  
  231.  
  232. Step by Step mode
  233. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  234.     ** Fileselector **
  235.  
  236.     You must specify the path where the TGA files will be saved, their
  237. default name is:
  238.     FRM00001.TGA (up to 99999 different files!)
  239.     You can change the first 7 characters by entering them into the
  240. 'File name' field of the fileselector. They will replace 'FRM'.
  241.  
  242.     ** Mini Menu **
  243.  
  244.     (S) save: saves the current frame
  245.     (A) all : saves all the frames (starting at the current one), you
  246.     can stop that with the Control key.
  247.         (a bell during saving indicates a write error, maybe Disk
  248.         full or else)
  249.     (Q) quit: quits
  250.     Esc    : same as above
  251.     (R) run    : displays automatically the frames until you use the
  252.     Control Key.
  253.     Other   : any other key advances one step ahead into the file.
  254.  
  255.     ** TGA Files **
  256.  
  257.     format: TGA 2 uncompressed, header is 18 bytes long:
  258.  
  259.     Long $00000200
  260.     Long $00000000
  261.     Long $00000000
  262.     Word width    (Intel)
  263.     Word height    (idem)
  264.     Word $1820
  265.     Then the pixels line by line with 3 bytes per pixel:
  266.     Blue/Green/Red.
  267.